home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 15 / BBS in a box XV-2.iso / Files II / Newton / Utilities / SleepAid 1.3.sit / ReadMe.dos / ReadMe.dos
Encoding:
Text File  |  1995-03-05  |  9.1 KB  |  189 lines  |  [TEXT/ttxt]
  1. SleepAid 1.3
  2. (C)1994-5 Innovative Computer Solutions, All Rights Reserved
  3. Written by Dan Rowley, Documentation/Icons by Tom Collins
  4.  
  5. < Overview >
  6.     SleepAid covers all aspects of power management on your Newton
  7. (Classic, MP100, MP110 or German MP).  It replaces the default "Sleep"
  8. preferences allowing you to set two sleep times - one for battery and one
  9. for AC.  It lets you reboot or sleep your Newton even if some errant
  10. application wants it to stay awake.  And finally, it adds a SleepAidNow
  11. corner for one tap sleep and a HeapStatus corner for an instant reading of
  12. free heap space.  SleepAid is not a radical change from the existing
  13. interface.  It adds functionality without complexity and implements sleep
  14. the way it should have been in the first place.  :-)
  15.  
  16. < Installation Notes >
  17.     If you are upgrading from SleepAid 0.9b, please launch the old SleepAid
  18. and tap on "Kill Prefs" before removing the package.  Users of later
  19. versions of SleepAid do not need to remove their prefs before upgrading to
  20. SleepAid 1.3.
  21.  
  22.     Use the "memory" preferences panel or some other package removal
  23. utility to remove the old version.  Once the old version of SleepAid has
  24. been removed, you can install SleepAid 1.3.
  25.  
  26.     Install SleepAid as you would any other package (with the Connection
  27. Kit or some other utility).  SleepAid will work if installed on a PCMCIA
  28. card, but we do not recommend it.  If you remove the card SleepAid is
  29. installed on, it will not exhibit the Grip Of Death (provided it is not
  30. open), but it WILL deactivate itself.  So, even though SleepAid works fine
  31. from a card, it is not active (because it is not present) if you remove the
  32. card it's on.  SleepAid picks up where it left off (i.e.; it remembers its
  33. settings) when you reinsert the card.
  34.  
  35.     It's a good idea to go into the SleepAid prefs right after installing
  36. it, because you may not like the defaults.  Until you set the prefs,
  37. SleepAid will maintain your existing sleep time for both AC and battery
  38. power.
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49. < SleepAid Preferences >
  50.     When SleepAid starts up, it replaces the Newton's default Sleep
  51. preferences.  You access the new preferences the same way you accessed the
  52. old preferences - they appear in the same location on the preferences roll.
  53.  The new preferences use sliders instead of a popup menu for setting a
  54. sleep time for battery power and AC power ("plugged in").  Once installed,
  55. SleepAid monitors battery status and updates the sleep time accordingly.
  56.  
  57.     On the Classic MP, SleepAid will think that you are plugged in if you
  58. have fresh batteries (the only way to detect an AC connection on a Classic
  59. MP is to check for a 100% battery level).  On the MP100 and MP110 you can
  60. use the new calibrate feature to enable true AC sensing.
  61.  
  62.     Tap the "Calibrate" button to set the low/high power threshold to the
  63. current battery level.  On the MP100 and MP110, this level will appear as
  64. "AC sense" if you calibrate when your AC adapter is plugged in.
  65.  
  66.     To activate or deactivate the "SleepAidNow" (lower-left) or
  67. "HeapStatus" (lower-right) corners, tap the checkboxes by each item. 
  68. Changing these setting requires special processing.  If you make a change
  69. to either of these "hot corners", a "Set" button will appear.  You must tap
  70. this button when you are finished, or the "hot corner" changes will not
  71. take effect.
  72.  
  73.     You can tap the SleepAidNow corner (over the "N" in Names) to instantly
  74. launch SleepAid.  If you hold your tap for more than one second, the
  75. MessagePad will immediately go to sleep.  You can tap the HeapStatus corner
  76. (over the "t" in Assist) to have a small window with a current free heap
  77. reading.  If you hold your tap for more than one second, SleepAid will
  78. peform a garbage collection, possibly freeing up more heap space.
  79.  
  80. < Usage >
  81.     You can launch the SleepAid application from your Extras drawer or the
  82. SleepAidNow corner (see above) to perform additional power management
  83. tasks.
  84.  
  85.     Tap on "?" to get more info on SleepAid (including registration
  86. information).
  87.  
  88.     Tap on "Reboot!" to reset your Newton.
  89.  
  90.     Tap on "Sleep!" to put your Newton to sleep.  If there are any other
  91. applications installed that won't let your Newton sleep, SleepAid will give
  92. you the option to kill their sleep handlers so your Newton can get some
  93. rest.  SleepAid will attempt to find the owner of the recalcitrant sleep
  94. handler but may respond with a cryptic name such as "petermain" (the name
  95. of the Inspector interface).  At this point, your guess is as good as
  96. ours.
  97.  
  98.     Tap on "Open Prefs" to open the SleepAid preferences.
  99.  
  100.     Tap on "Kill Prefs" to remove SleepAid's soup entry.  If you don't plan
  101. on using SleepAid again, use the "Kill Prefs" button before you remove the
  102. package from your Newton.
  103.  
  104. < Technical Information >
  105.     SleepAid makes use of an InstallScript to install the power monitoring
  106. routines.  If you use a utility that disables this function, SleepAid will
  107. not work properly.  If you don't want SleepAid to be active, simply remove
  108. the package.  SleepAid will remember your preferences even when
  109. deinstalled, unless you use the "Kill Prefs" option from the application
  110. before you remove it.
  111.  
  112.     To conserve battery power, SleepAid only checks the battery status
  113. every 30 seconds.  If you have set an exceptionally short sleep time (like
  114. 30 seconds) for battery operation, it's POSSIBLE (but not likely) that
  115. SleepAid may not notice if you plug in the Newt in time to prevent it from
  116. falling asleep.  If this is really a problem, you can tap the screen after
  117. plugging your Newt in to keep it awake "a little longer."  We should note
  118. that we've never actually seen this happen, but it IS theoretically
  119. possible (sort of like cold fusion or a balanced federal budget).
  120.  
  121. < Release History>
  122. 1.3  - 3/5/95 - Tuned up the code to use less heap (from 5.9k to 3.9k with
  123. all features enabled, uses even less when stored internally).
  124. 1.2  - 5/30/94 - Added HeapStatus, Calibrate, and enable/disable for
  125. SleepAidNow and HeapStatus.
  126. 1.01 - 4/10/94 - Fixed incompatability with some applications using modal
  127. dialogs.
  128. 1.0  - 4/03/94 - Fixed to work with MP 110 and German MP.  Added
  129. SleepAidNow.
  130. 0.9b - 2/20/94 - First public release.  Tested on two MessagePads with OS
  131. v1.11.
  132. 0.6b - 2/09/94 - First semi-stable version.  No more Grip Of Death.
  133. 0.2b - 1/18/94 - You don't even want to know.
  134.  
  135. < Shareware Registration Information >
  136.     This application is SHAREWARE.  If you decide to keep it, please
  137. register it by sending $5.00 to Innovative Computer Solutions; ATTN: Tom
  138. Collins; 1075 North Miller Road, #142; Scottsdale, Arizona USA 85257-4612. 
  139. Please include your name, the name of this utility (SleepAid 1.3), type(s)
  140. of MessagePad(s) owned, address (postal) and preferred e-mail address so we
  141. can contact you about updates and our other products.  You can also
  142. register SleepAid on CompuServe for $6.  GO SWREG and register app number
  143. 2674.  PLEASE BE HONEST and register this software if you use it - we can't
  144. continue to write cool Newton apps if we don't get any support.
  145.  
  146. < Bugs, Questions, Comments, Suggestions... >
  147.     Send e-mail to the author, Dan Rowley, at ics@amug.org or 73563,2343 on
  148. CompuServe.  You can also reach Tom at ics@indirect.com or 75460,2121 on
  149. CompuServe.  We want to develop Newton applications to fit YOUR needs. 
  150. Give us feedback, let us know if we're doing it right.  We're here for
  151. you.
  152.  
  153.     If you'd like the latest versions of our software, and can't find them
  154. on CompuServe, America Online, comp.binaries.newton, or the Newton FTP
  155. sites, contact us via e-mail and we'll send them to you.  Our WWW home page
  156. is <http://www.indirect.com/ics/newton/> and our ftp directory is
  157. <ftp://ftp.indirect.com/pub/ics/>
  158.  
  159. < Our Other Stuff >
  160.     Check out our other popular Newton utilities, NewtCase, NewtInfo,
  161. HeapIt, GraffitiPatch, inLine and PrefsPatch.
  162.  
  163. < Legal Mumbo Jumbo >
  164.     Newton, MessagePad, Connection Kit and Apple are registered trademarks
  165. of Apple Computer, Inc.  SleepAid is a trademark of Innovative Computer
  166. Solutions.
  167.  
  168.     You can't sell SleepAid, but you can charge a nominal fee for connect
  169. time or media (not to exceed $5).  Contact the authors if you plan to
  170. include it in some sort of freeware/shareware collection.
  171.  
  172.     In using this software, you understand and agree that this software is
  173. provided "as is" without warranty of any kind.  The authors do not make any
  174. warranties, either expressed or implied, including but not limited to
  175. implied warranties of merchantability and fitness for a particular purpose,
  176. with respect to this software.
  177.  
  178.     In no event shall the author be liable for any consequential,
  179. incidental, or special damages whatsoever (including without limitation,
  180. damages for loss of critical data, loss of profits, interruption of
  181. business and the like) arising out of the use or inability to use this
  182. software.
  183.  
  184.     Have a nice day.  ;-)
  185.  
  186. Innovative Computer Solutions / (602) 970-1032
  187. 1075 N. Miller Rd. #142 / Scottsdale, Arizona USA 85257
  188. Dan Rowley/ics@amug.org/CIS: 73563,2343/eWorld&NewtonMail: DRowley
  189. Tom Collins/ics@indirect.com/CIS: 75460,2121/eWorld&NewtonMail: Innovative